home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / GRAPHICS / @FALCON / VIEWERS / MPLAYER.230 / MPLYR_EN.DOC < prev    next >
Encoding:
Text File  |  1996-12-30  |  12.4 KB  |  368 lines
  1. ****************************************************************************
  2.         M_PLAYER.PRG DOCUMENTATION Version 2.30
  3. ****************************************************************************
  4.  
  5.          It's a Quick Time and AVI player with sound,
  6.           and a FLI/FLC/FLH, SEQ, PI1+DLT, FLM, DL, GIF player.
  7.           It can also CREATE Quick Time files (Images & sound)
  8.               and GIF animated files (without sound)
  9.  
  10.  
  11. *************************************************************
  12. WARNING: Res-change on the Falcon, see at the end of this DOC
  13. *************************************************************
  14. WARNING: TT without graphic card, see at the end of this DOC
  15. *************************************************************
  16.  
  17. Author:
  18.  
  19. TELLO Guillaume
  20. 240 rue Estienvrin
  21. 49260 Montreuil Bellay
  22. FRANCE
  23.  
  24. Email: gtello@planete.net
  25.  
  26. Download M_PLAYER from:
  27.     http://www.tripnet.se/~mille
  28.     http://www.magmacom.com/~nima
  29.  
  30.  
  31.  
  32. ********** Shareware ****************
  33.  
  34.     If you want to register, please send 15DM, CAN$15, US$10, 60F or
  35. 7UKP to me or to my bank:
  36.     Crédit Agricole Anjou Mayenne/49000 Angers (France)
  37.     Account n°10434852000
  38.  
  39.     North America User, you can register (US$10) at:
  40.  
  41.     Nima Montaser          Hardware and Software Specialists
  42.     Homa Systems House       ATARI Graphics and Multimedia
  43.        P.O. Box 52127          nima@magmacom.com
  44.        Ottawa, ON  K1N 5S0     aa414@freenet.carleton.ca
  45.        Canada   Tel:(613)722-0901   Fax:(613)722-9061
  46.                URL: http://www.magmacom.com/~nima
  47.  
  48.         UK users, you can register (7UKP or more!) at:
  49.  
  50.         Antony Lacey   (algy@allatsea.demon.co.uk)
  51.     59 Owenford Road
  52.     Radford
  53.     Coventry CV6 3FQ
  54.     England
  55.  
  56.  
  57.         G E N E R A L   C O N S I D E R A T I O N S
  58.         *******************************************
  59.  
  60. Capabilities:
  61. ╣╣╣╣╣╣╣╣╣╣╣╣╣
  62.     1) Can create Quick Time movies from a serie of images (and an
  63. optional sound), images formats are:
  64.         - TGA2 16 or 24 bits (to RLE16 compression)
  65.         - IMG ('ximg', 256 colors) (to RLE8 compression)
  66.     Sound formats are:
  67.         - AVR, 8/16 bits, mono/stereo
  68.         - WAV, 8/16 bits, mono/stereo
  69.     (see below BATCH files, and SLIDSHOW.DOC)
  70.  
  71.     2) Can create GIF Animated files from a serie of GIF images (87a
  72. or 89a):
  73.         - M_PLAYER extension with number of frames
  74.         - DELAY extension with the timing infos
  75.         - NETSCAPE extension with the looping infos
  76.     (see below BATCH files, and SLIDSHOW.DOC)
  77.  
  78.     3) Can play 10 types of animations:
  79.     - *.MOV (Quick Time)
  80.         - graphics with:
  81.             CVID (compressed yuv)
  82.             RLE1, RLE2 (grey or col), RLE4 (grey or col),
  83.             RLE8 (grey or col), RLE16, RLE24, RLE32
  84.             SMC8 (grey or col)
  85.             RAW1, RAW2 (grey or col), RAW4 (grey or col),
  86.             RAW8 (grey or col), RAW16, RAW24, RAW32
  87.             RPZA (15 bits)
  88.             YUV2, YUV9, YVU9 (uncompressed yuv)
  89.         - sound mono/stereo, 8/16 bits with TWOS or RAW format
  90.         - switch for image-sound synchronisation
  91.         - switch for sound
  92.     - *.AVI (Video for Windows)
  93.         - graphics with:
  94.             CVID
  95.             CRAM16, CRAM8
  96.             MSVC16, MSVC8
  97.             RLE8
  98.             RGB8
  99.             YUV9, YVU9
  100.         - sound mono/stereo, 8/16 bits with TWOS or RAW format
  101.         - switch for image-sound synchronisation
  102.         - switch for sound
  103.  
  104.     - *.FLI/FLC/FLH (Autodesk Animator)
  105.     - *.SEQ        (Cyber Paint)
  106.     - *.PI1 + *.DLT    (Cyber)
  107.     - *.FLM        (Kinetic Microsystems)
  108.     - *.FLM        (Lexicor)
  109.     - *.DL        (types 1 and 2)
  110.         - graphics only
  111.         - normal speed or maxi speed
  112.         - loop mode (Shift key)
  113.         (for PI1 + DLT, you must select the PI1 file, then the DLT
  114.         file must share the same name and be located into the same
  115.         directory: c:\EXAMPLE.PI1 and c:\EXAMPLE.DLT)
  116.  
  117.     - *.GIF        (Compuserve, 87a and 89a)
  118.         - synchro or not with the delays (version 89a)
  119.         - number of frames displayed in the stats dialog only
  120.  
  121.     - step by step mode
  122.         - every frame displayed (auto or not)
  123.         - can save this frame into a TGA file (auto or not)
  124.         - doesn't work with NOVA or TT 256 colors
  125.  
  126.     - *.BAT (Batch files for slideshow):
  127.         - simple language to load and display a serie of images
  128.         - image format:
  129.             TGA 2 uncompressed (your POV creations for example)
  130.             IMG ('XIMG' and 256 colors)
  131.             GIF (87a or 89a, 256 colors maxi)
  132.         more formats will be added in the furture
  133.         (see SLIDSHOW.DOC)
  134.  
  135.  
  136. Hardware requiered:
  137. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  138.     - Atari TT030:
  139.         - graphic cards accepted:
  140.             - NOVA (256 or 32768 colors)
  141.             - Crazy Dots1/2 (256 or 32768 colors)
  142.             - Matrix (256 colors)
  143.             - Cyrel (256 colors)
  144.         - without graphic card (256 colors)
  145.  
  146.     - Falcon, True Color (32768 colors) and plenty of RAM (Outside
  147.     accepted! Afterburner 040, ScreenBlaster, Blow up,
  148.     Centurbo I)
  149.     - PowerBook with MagicMac (256 colors, without sound...)
  150.     - HADES 060 (without sound...)
  151.  
  152.  
  153. Damn!, I've got 16Mb of TT RAM, and DMA sound can't be played from it!
  154. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  155.  
  156.     Well, you should set the 'TT Load' and 'TT Malloc' flags of the
  157. program to keep the largest possible amount of ST RAM free. TT RAM is then
  158. used to load the remaining sound data if it doesn't all fit into ST RAM.
  159. While playing, this data is then copied into ST RAM by blocks till the end
  160. of the animation. A copy of 1.5Mb takes 0.5sec. You may get some small
  161. gaps in the sound while it is being copied across.
  162.  
  163.  
  164.         R U N N I N G   T H E   P R O G R A M
  165.         *************************************
  166.  
  167. The files:
  168. ╣╣╣╣╣╣╣╣╣╣
  169.     M_PLAYER.PRG    ; the program
  170.     M_PLAYER.RSC    ; the dialogs (put into the same folder!)
  171.     MPLYR_FR.DOC    ; french documentation
  172.     MPLYR_EN.DOC    ; english documentation (Thanks Dave!)
  173.     MPLYR_GE.DOC    ; german documentation (Thanks Martin)
  174.     MPLYR_SV.DOC    ; swedish documentation (Thanks Mille)
  175.     MP_ICONS.RSC    ; 4 icons made by Julien Chauveau for your desktop.
  176.     SLIDSHOW.DOC    ; batch files and MOV-Maker
  177.     HISTORIC.TXT    ; the history
  178.     COMMANDS.DOC    ; the options of the command line (TTP mode)
  179.  
  180. Running:
  181. ╣╣╣╣╣╣╣╣
  182.     You can double-click on it (you'll get the fileselector), here
  183. you can specify the filename or a mask (*.MOV).
  184.     You can also drag and drop one animation on it (the fileselector
  185. will be skipped).
  186.  
  187.     First dialog:
  188.  
  189.     1) The first part indicates the name and the type of file
  190.     detected.
  191.  
  192.     2) The green box gives informations about the video data (size,
  193. number of frames, compression) and if the compression is supported or
  194. not. If you have selected a sound-only file, you will get a message
  195. saying 'No graphics found'. This dialogue also indicates whether the
  196. video format is supported or not. If it is not supported, M_PLAYER
  197. will still play any sound data that may be present, but there will be
  198. no video.
  199.  
  200.     3) The orange box gives information about the sound (frequency,
  201. resolution, channels). Some frequencies and resolutions (4bits) are not
  202. supported. Sometimes you'll get the 'Supported' message but you get no
  203. sound: this means that the system has run out of memory. If there is no
  204. sound data present, You will get the message 'No Sound'. The file will
  205. still play but it will be in video only.
  206.  
  207.     4) The 'Play Sound' box selects/deselects sound playing (subject to
  208. sound data being present of course!).
  209.  
  210.     5) The 'Synchronize' box selects/deselects synchronization between
  211. sound and video (subject to sound and video data being present of
  212. course!).
  213.  
  214.     4b) 'Max speed' is a switch for FLx/SEQ to display the frames
  215. without any delay between them.
  216.  
  217.     5b) FLx: else (when max speed isn't set), you can select here the
  218. correct speed in frames per second.
  219.  
  220.     6) 'Informations...' gives informations.
  221.  
  222.     7) 'Go!' starts the animation. If sound data needs loading, playback
  223. will be delayed and you will see a dialogue box saying 'Loading
  224. sound...'.
  225.     If "(Alt) Go!" is available and that you use it, you'll enter the
  226. Step by step mode (see below).
  227.     With a BATCH file, 'Alt' key toggles between slide-show and
  228. create-movie.
  229.  
  230.     8) 'Cancel' does just that.
  231.  
  232. Statistics:
  233. ╣╣╣╣╣╣╣╣╣╣╣
  234.     At the end of an animation, a BOX with statistics is displayed, if
  235. the movie was only a sound file, this box is skipped:
  236.     * Total frames:    the number of video frames in the file.
  237.     * Frames displayed: the number of video frames actually displayed
  238. (100% without sound synchronisation, sometimes less with synchronisation
  239. because some of them have been skipped to 'follow' the sound data).
  240.     * Total time: the duration of the animation in seconds.
  241.     * Average: number of frames actually displayed every second.
  242.  
  243. Program ending:
  244. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  245.     If you've started with a fileselector, you'll be back in it after
  246. every animation. You must choose 'cancel' from the selector to quit.
  247. With drag and drop, you'll return automatically to the desktop.
  248.  
  249. How to stop an animation?
  250. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  251.     With the 'Control' key (no stats box).
  252.     With SHIFT and an animation that loops (GIF for example), the
  253. display is stopped at the end of the current loop and you get the stats
  254. box.
  255.  
  256.  
  257. Step by Step mode
  258. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  259.     ** Fileselector **
  260.  
  261.     You must specify the path where the TGA files will be saved, their
  262. default name is:
  263.     FRM00001.TGA (up to 99999 different files!)
  264.     You can change the first 3 characters by entering them into the
  265. 'File name' field of the fileselector. They will replace 'FRM'.
  266.  
  267.     ** Mini Menu **
  268.  
  269.     (S) save: saves the current frame
  270.     (A) all : saves all the frames (starting at the current one), you
  271.     can stop that with the Control key.
  272.         (a bell during saving indicates a write error, maybe Disk
  273.         full or else)
  274.     (Q) quit: quits
  275.     Esc    : same as above
  276.     (R) run    : displays automatically the frames until you use the
  277.     Control Key.
  278.     Other   : any other key advances one step ahead into the file.
  279.  
  280.     ** TGA Files **
  281.  
  282.     format: TGA 2 uncompressed, header is 18 bytes long:
  283.  
  284.     Long $00000200
  285.     Long $00000000
  286.     Long $00000000
  287.     Word width    (Intel)
  288.     Word height    (idem)
  289.     Word $1820
  290.     Then the pixels line by line with 3 bytes per pixel:
  291.     Blue/Green/Red.
  292.  
  293.  
  294.         S O M E   Q U E S T I O N S
  295.         ***************************
  296.  
  297. How was it done?
  298. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  299.     I used ASSEMBLE (Brainstorm), the fastest and the best assembler
  300. I've ever seen.
  301.  
  302. Frequencies
  303. ╣╣╣╣╣╣╣╣╣╣╣
  304.     MAC or PC files have mainly use one of 3 frequencies: 11kHz, 22kHz
  305. or 44kHz. When M_PLAYER loads the sound, it makes a frequency conversion
  306. to get 12,5kHz or 25kHz or 50kHz which are the DMA frequencies (each 8
  307. bytes per block, it repeats the last byte, so getting 9 bytes and that's
  308. all).
  309.  
  310. Bugs?
  311. ╣╣╣╣╣
  312.     - Metados works now (version 2.70)
  313.     - The animation is larger than the screen (you should try, maybe
  314. it won't crash for you), then use a virtual screen.
  315.     - Turbo Veille bug fixed (V1.36).
  316.     - Extendos bug is fixed (V1.36, thanks to Yu-Ou Wang)
  317.     - Freedom bug fixed (V2.05)
  318.     - FPATCH2.PRG can correct some sound problems.
  319.  
  320.     Thanks to:
  321.  
  322.     - Pascal Ricard (Pierrevert, France, Falcon 4Mo)
  323.     - Julien Chauveau (Méron, France, Falcon 4Mo)
  324.     - Hervé Piedvache (Paris, Falcon 4Mo)
  325.     - Dave Brook (Stony Sratford, England, TT 20Mo + Crazy Dots 2)
  326.     - Magnus Kollberg (Sweden, Falcon 4Mo)
  327.     - Martin Rothaemel (Germany, TT 8Mo + NOVA)
  328.     - Yu-Ou Wang (Paris, Falcon 40MHz)
  329.     - Oliver Skelton (South Croydon, GB, Falcon + BlowUp Hard 1)
  330.     - Jacobo Morro (Spain, Falcon)
  331.     - Rémi Vanel (France, Falcon)
  332.  
  333.  
  334. ********************
  335. Res-change on Falcon
  336. ********************
  337.  
  338.     The programs, if not lauched in True Color, switches to TC to
  339. display an animation. I give no warranty about the safety of my routine, I
  340. won't pay for any damage caused to your monitor (the routine has been
  341. succesfully tested from 16 and 256 color modes, it didn't work from
  342. monochrome or 4 color modes).
  343.  
  344.     The only way to avoid this switch is to launch M_PLAYER in TC from
  345. the desktop.
  346.  
  347.     If your monitor makes a 'clunk' at every res-change, you should be
  348. careful, if it doesn't and seems to support it, well, do what you want.
  349.  
  350. ***********************
  351. TT without graphic card
  352. ***********************
  353.  
  354.     The displays switches to 320x480x256 to play the animations. If
  355. the height allows it, the animation is doubled to correct the aspect
  356. ratio, if the width is greater than 320 pixels, the image is reduced to
  357. its half: finaly, every animation up to 640x480 is accepted.
  358.     Limits are those of the NOVA 256 colors mode:
  359.     - 16bits or TC animations are replayed in grey
  360.     - other animations are replayed in colors (<=256)
  361.     - no step by step mode
  362.  
  363.     The display is slower than with a graphic card, because instead of
  364. writting directly into the video RAM, the program uses a buffer witch is
  365. re-encoded bit by bit into the video RAM.
  366.     For some specific animations (SEQ, DLT, FLM, DL) a routine adapted
  367. to the TT has been included, so you'll get a very good speed with those
  368. anims.